home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / partnr11.arc / PARTNERS.DOC < prev    next >
Encoding:
Text File  |  1987-02-27  |  42.7 KB  |  1,481 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                               EQUAL PARTNERS
  23.  
  24.  
  25.                            Virtual disk system
  26.  
  27.                                Version 1.10
  28.  
  29.  
  30.  
  31.  
  32.                   K.eeping I.nformation S.haring S.imple
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.     "If you know DOS then you already know how to use Equal Partners."
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.          COPYRIGHT (c) 1985, 1986, 1987 by Downlink Systems Inc.
  54.          ALL RIGHTS RESERVED
  55.  
  56.  
  57.  
  58.      This document describes the EQUAL PARTNERS virtual disk  system,
  59.      version 1.10, which was created by Downlink Sys. in December of 1986.
  60.  
  61.  
  62.  
  63.                                   INTRODUCTION
  64.  
  65.  
  66.  
  67.      EQUAL PARTNERS is the copyrighted property of Downlink Sys. Inc.
  68.      You are granted a limited license to use , and to copy it and
  69.      distribute it, provided that the following conditions are met:
  70.  
  71.      1) No fee may be charged for such copying and distribution.
  72.  
  73.      2) EQUAL PARTNERS may ONLY be distributed in its original, unmodified
  74.         state.
  75.  
  76.      Contributions for the use of this program will be appreciated, and
  77.      should be sent to:
  78.  
  79.                              Downlink Systems Inc.
  80.  
  81.                              c/o D. Conner
  82.                              1377 K. STREET N.W.
  83.                              SUITE 189
  84.                              WASHINGTON D.C.
  85.                                              20005
  86.  
  87.      You may not use this product in a commercial environment or a
  88.      governmental organization without paying a license fee of $40.
  89.      Site licenses and commercial distribution licenses are available.
  90.      A program disk and printed documentation are available for $40.
  91.      See the order form in the back of this manual for more details.
  92.  
  93.  
  94.      EQUAL PARTNERS is user supported software.  This means that you may
  95.      copy the shareware version freely and give the copies away to anyone
  96.      you wish, at no cost. They in turn are requested to send in a contri-
  97.      bution if they decide to use it.
  98.  
  99.      The user supported software concept (often referred to as shareware)
  100.      is an attempt to provide software at low cost.  The cost of offering a
  101.      new product by conventional means is staggering, and hence dissuades
  102.      many independent authors and small companies from developing and
  103.      promoting their ideas.  User supported software is an attempt to
  104.      develop a new marketing channel, where products can be introduced at
  105.      low cost.
  106.  
  107.      If user supported software works, then everyone will benefit.  The
  108.      user will benefit by receiving quality products at low cost, and by
  109.      being able to "test drive" software thoroughly before purchasing it.
  110.      The author benefits by being able to enter the commercial software
  111.      arena without first needing large sources of venture capital.
  112.  
  113.      But it can only work with your support.  We're not just talking about
  114.      EP here, but about all user supported software.  If you obtain a user
  115.      supported program from a friend or colleague, and are still using it
  116.      after a couple of weeks, then it is obviously worth something to you,
  117.      and a contribution should be sent. Upon receipt of a contribution,
  118.      you become a registered user and will receive a "full" feature, serial-
  119.      ized version of EQUAL PARTNERS.
  120.  
  121.                                    ii
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  I. WHAT IS EQUAL PARTNERS.
  128.  
  129.     Equal Partners is a software solution to the problem of sharing data
  130.   between 5 1/4 floppy based PC's and the new emerging convertibles
  131.   and lap-tops that use the 3 1/2 floppy drives and diskettes,
  132.   between different PC's with dissimiliar disk(ette) storage media,
  133.   or between different PC's with identical recording media!.
  134.  
  135.     Equal Partners addresses this problem by using inexpensive RS-232
  136.   serial adapters , software device drivers and communication programs
  137.   to attach the physical drives of one PC to the DOS operating system
  138.   of another PC. These physical drives become an extension of and to
  139.   the operating system of the other PC so that all DOS functions that
  140.   use a drive letter,to access data, function without concern that
  141.   these 'virtual' drives are not truly physically attached to the
  142.   floppy/hard disk controller cards.
  143.  
  144.  
  145.  II. WHY USE EQUAL PARTNERS
  146.  
  147.    Equal Partners provides a cost effective solution,as opposed to the
  148.   solution that IBM provides. IBM's solution is hardware based and
  149.   requires an additional out-of-pocket expense in the neighborhood
  150.   of $500.00. Equal Partners allows you to try its low cost solution
  151.   for a reasonable time. Then if you realize the cost savings, to
  152.   compensate the authors for their efforts and for your peace of mind.
  153.    We are sure you would rather use the $500.00 you saved, to invest,
  154.   expand and/or enrich your life in other ways.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.                                     - 1 -
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  III. HOW DO YOU ACQUIRE USAGE RIGHTS TO EQUAL PARTNERS.
  190.  
  191.    Equal Partners is not totally free, a small contribution is asked
  192.   to allow the authors to feel that their efforts did not fall on
  193.   unfertile ground.
  194.  
  195.    The contribution can consist of several forms:
  196.  
  197.      FOR INDIVIDUALS
  198.      ----------------
  199.  
  200.         1.  Monetary
  201.             --------
  202.  
  203.             A registration and usage fee of $40.00 is asked, of
  204.           individuals. This will provide you with notices of
  205.           upgrades and fixes, as well as allow you access to
  206.           a version supporting additional com ports and faster
  207.           transfer speeds plus other additional features.
  208.  
  209.  
  210.          2). Personal
  211.              --------
  212.  
  213.             Another alternative , if money is a major negative
  214.           factor, is that we deeply request that you give a part of
  215.           yourself. Instead of a pound of flesh, a donation to your
  216.           local Red Cross of 1 pint of blood so that another may
  217.           'profit' from your 'gain'/'loss'. This is the least
  218.           contribution asked and expected.
  219.  
  220.  
  221.        FOR COMPANYS
  222.        ------------
  223.  
  224.           1) Monetary
  225.              --------
  226.  
  227.              For businesses, that benefit from additional utility
  228.            and time/cost savings, a per copy or site-license is
  229.            available and required. Otherwise, no usage license is
  230.            granted, and any use is strictly prohibited.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.                                     - 2 -
  246.  
  247.  
  248.  
  249.  
  250.  
  251.   IV. HOW DO YOU USE EQUAL PARTNERS
  252.  
  253.  
  254.       First read the section on REQUIREMENTS, to see if your machine
  255.      and its hardware configuration can meet the necessary requirements.
  256.  
  257.       Secondly, install Equal Partners (see INSTALLATION section). Now the
  258.      easy part begins.
  259.  
  260.       You say, "nothing is ever easy". We say , "if you know DOS then you
  261.      know how to use Equal Partners".
  262.  
  263.       Granted you may not, yet, be a "POWER USER", but we bet you know how
  264.      to see whats on your disks, does the "DIR" command ring a bell. Now that
  265.      you know whats there, we also bet you got it there with the DOS "COPY"
  266.      command or someone did. Starting to catch on yet, we havent tried to
  267.      teach you any new convoluted commands with unfamiliar structure and
  268.      syntax , have we. Guess what!!. You have just graduated from the ACME
  269.      self study and enlightment course that certifies you as a "POWER USER"
  270.      of Equal Partners. Take a break, you deserve it. Oh, come back later
  271.      to get your EPPU 'certificate of achivement'.
  272.  
  273.       Back so soon?.
  274.  
  275.      Now to the serious business side of matters. You have all this data
  276.     , in some form or another, and you need to :
  277.  
  278.             consolidate/manipulate/share/archive/transport
  279.  
  280.     it between/among/with/to another/same media on another PC.
  281.  
  282.      Being a Equal Partners "POWER USER" (EPPU), you know that all you
  283.     have to do is use the DOS "COPY" command. So, do it, and give yourself
  284.     a pat on the back for a job well done.
  285.  
  286.      We could go on with how to use the other DOS commands, but we are
  287.     sure you are ahead of us already. What more can we say, in 25 words
  288.     or less, that would not confuse you. Again let us stress, if you
  289.     need to access data on the 'server' PC, just use the DOS commands
  290.     and the disk drive letters of the 'virtual drives' that are now
  291.     logically attached to your PC.
  292.  
  293.      Also, we are sure that you have guessed by now, that if you can
  294.     tell DOS where to get the data you need, for a program it should
  295.     be just as easy. Sure is, just 'tell' the program that the data it
  296.     needs is on one of the 'virtual drives' and business should
  297.     continue as always (unless that 'break-even' analysis formula
  298.     in the spreadsheet is in error).
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.                                     - 3 -
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  REQUIREMENTS
  314.  ------------
  315.  
  316.   The hardware requirements are:
  317.  
  318.  
  319.         1). Your machine must be an IBM PC/XT/AT or highly compatible,
  320.            including laptops and convertibles.
  321.  
  322.         2). The machine uses an 8250 uart,or compatible, to handle
  323.            the RS232C communications.
  324.  
  325.         3). The RS232C cable must have pins 2 and 3 crossed or
  326.            a straight thru cable with a null modem.
  327.  
  328.         4). The machine uses the port addresses at memory location
  329.            0:400. The port addresses are 03F8 for COM1, and 02F8
  330.            for COM2.
  331.  
  332.         5). The disk media must be Dos formatted, in other words
  333.            the boot sector must contain the BPB info that describes
  334.                            -------------------------
  335.            the media (the media type in the FAT is not used). Some
  336.            vendors that format their own disks do not bother to put
  337.            the BPB info in logical sector 0, even thought the Dos 3.2
  338.            Technical Ref. manual says that Dos will no longer rely
  339.            on the Media code in the FAT to determine the device
  340.            characteristics.
  341.  
  342.          6). As always, sufficient memory must be available.
  343.  
  344.  
  345.     The software requirements are:
  346.  
  347.  
  348.          1). The operating system must be PC Dos 2.0 or above.
  349.  
  350.              This product has been tested on PC DOS 2.0 , 2.1,
  351.             3.0, 3.1, 3.2 and 3.21.
  352.  
  353.          2). The PC DOS versions running on both the "server" and
  354.             the "remote(s)" SHOULD be identical!!
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.                                     - 4 -
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  INSTALLATION
  376.  ------------
  377.  
  378.      Equal Partners consists of the following files:
  379.  
  380.         50-50.SYS       -  device driver
  381.  
  382.         EQUAL.COM       -  communication program
  383.  
  384.         PARTNERS.COM    -  communication program
  385.  
  386.         PARTNERS.DOC    -  this documentation
  387.  
  388.         SERVER.BAT      -  example batch file, with ERRORLEVEL checking
  389.  
  390.         REMOTE.BAT      -  example batch file, with ERRORLEVEL checking
  391.  
  392.         ????????.???    -  any additional files as the product matures
  393.  
  394.     Installation assumes two PC's, and the need to exchange data
  395.    between the PC's. One PC will be designated the 'server' PC
  396.    and the other PC(s) the 'remote' PC(s).
  397.  
  398.     The PARTNERS.COM program may be loaded on and is normally run
  399.    from the 'server' PC. The 'server' Pc could be considered the 'base'
  400.    PC in that it would normally contain all the master database and
  401.    spreadsheet programs and files. The 'remote' PC(s) could be lap-tops
  402.    that individuals had taken 'on-the-road' with them to gather data,
  403.    for updating to the 'server' databases..ect.
  404.  
  405.    So, installation on the 'server' of PARTNERS.COM consists of
  406.                     --------------
  407.  
  408.          1). Copying PARTNERS.COM to a directory in the DOS path,
  409.              and typing the command , 'PARTNERS' or including it in
  410.              a Dos batch file.
  411.  
  412.              Command format:
  413.  
  414.                PARTNERS [/COMx]
  415.  
  416.              where the parameter in "[]" is optional and indicates the
  417.             hardware port to use for communications. Replace the "x"
  418.             with "1" or "2" to override the installation default.
  419.  
  420.             Note: the "[]" are NOT part of the command!.
  421.  
  422.             Note: the install results may be tested in a batch
  423.                  file with the ERRORLEVEL statement.
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.                                     - 5 -
  432.  
  433.  
  434.  
  435.  
  436.    Now, installation on the 'remote' consists of
  437.                      --------------
  438.            1). Including the following command in 'CONFIG.SYS'
  439.  
  440.  
  441.                DEVICE=50-50.SYS  'z' additional disk drives requested
  442.  
  443.  
  444.                (where 'z' can be any number from 1 to 8, default=1)
  445.  
  446.  
  447.            2). Copying EQUAL.COM to a directory in the DOS path
  448.                and typing the command, 'EQUAL' or including it in
  449.                a Dos batch file.
  450.  
  451.              Command format:
  452.  
  453.                 EQUAL   [/COMx]
  454.  
  455.              where the parameter in "[]" is optional and indicates the
  456.             hardware port to use for communications. Replace the "x"
  457.             with "1" or "2" to override the installation default.
  458.  
  459.             Note: the "[]" are NOT part of the command!.
  460.  
  461.             Note: the install results may be tested in a batch
  462.                  file with the ERRORLEVEL statement.
  463.  
  464.     Once installed , any DOS command that would normally access data
  465.    using a drive designation, will be able to read/write data from
  466.    one PC to the other PC(s). What this means is that you can 'COPY',
  467.    , 'ERASE', 'RENAME', 'PATH', and execute programs to/on/from
  468.    the 'virtual' drives without any new commands or procedures.
  469.  
  470.  
  471.    If you know DOS then you already know how to use Equal Partners.
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.                                     - 6 -
  493.  
  494.  
  495.  
  496.  
  497.                                  RAMDISK SUPPORT
  498.  
  499.  
  500.  
  501.      If you have a RAMdisk, or other high-speed storage, then you can speed
  502.      up EP  somewhat by telling DOS to read from/write to the RAMdisk.
  503.      You do this by substituting the drive letter of the RAMdisk in all
  504.      the MS-DOS commands.  For example, if drive H: is your virtual RAMdisk,
  505.      then you would type:
  506.  
  507.          COPY H:*.*  D:
  508.  
  509.          (where D: could be a RAMdisk on your 'remote' PC)
  510.  
  511.      Refer to the MS-DOS manual for more details about the DOS commands.
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.                                     - 7 -
  554.  
  555.  
  556.  
  557.  
  558.                       PROGRAM  EXECUTION RESTRICTIONS
  559.  
  560.  
  561.  
  562.      If are using a Shareware version on EQUAL PARTNERS, and have not
  563.      registered, then the following program executions restrictions
  564.      apply:
  565.  
  566.            1). Only 9,600 baud transfer rate is available.
  567.  
  568.            2). Only Com1 is supported.
  569.  
  570.            3). Only one virtual drive may be specified in
  571.                config.sys.
  572.  
  573.            4). Only reading is allowed, in otherwords you
  574.                may only copy data "from" the server. You
  575.                are not allowed to perform any Dos function
  576.                that would "write" to the server.
  577.  
  578.            5). The starting drive on the server is always the
  579.                "A:" drive. This means that the first virtual
  580.                drive assigned on the "remote" is the first
  581.                physical drive accessed on the "server".
  582.  
  583.  
  584.            6). Also some storage devices, such as a Bernoulli box,
  585.               may cause timing problems due to the fact that it may
  586.               require several seconds for the Bernoulli box to come
  587.               up to speed.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.                                     - 8 -
  615.  
  616.  
  617.  
  618.                               DISK DRIVE MAPPING
  619.  
  620.  
  621.  
  622.          This simple illustration shows how the drives and the letters
  623.        assigned are mapped to the physical vs. virtual drives.
  624.  
  625.  
  626.  
  627.  
  628.             'REMOTE'                                         'SERVER'
  629.  
  630.         +---------------+                                +---------------+
  631.         |  +---------+ o|                                |  +---------+ o|
  632.         |  |A:>dir C:| o|                                |  | Partners| o|
  633.         |  |         |  |                                |  |   v1.1  |  |
  634.         |  |Volume in|  |                                |  |Copyright|  |
  635.         |  +---------+  |                                |  +---------+  |
  636.         +---------------+                                +---------------+
  637.    +------------------------+                       +------------------------+
  638.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  639.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  640.    |                        |<--       ----         |                        |
  641.    +------------------------+  |                    +------------------------+
  642.               ^         ^      |        ^                      ^         ^
  643.               |         |      |        |                      |         |
  644.               |         |      |        |                      |         |
  645.           Physical  Physical   |      Null                 Physical  Physical
  646.           Drive A:  Drive B:   |     Modem                 Drive A:   Drive B:
  647.                                |
  648.                                |                               ^         ^
  649.                                |                               |         |
  650.                                |                               |         |
  651.                                |
  652.                                ------------------------->  Virtual   Virtual
  653.                                                            Drive C:  Drive D:
  654.  
  655.  
  656.      There may be Ramdisks on either or both the 'SERVER' and  'REMOTE'
  657.    PCs. Ramdisks are highly recommended, memory permitting, because this
  658.    eliminates all the mechanical delays that real hardware drives exhibit,
  659.    such as rotational delay, seek times and drive startup..ect.
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.                                     - 9 -
  676.  
  677.  
  678.  
  679.                              Usage Example NO. 1
  680.  
  681.  
  682.  
  683.          This simple illustration shows how EQUAL PARTNERS was used to
  684.        dial a remote BBS, with PCTALK III V7.01XA, and transfer data
  685.        to/from the "server" while BBS communications was maintained
  686.        on the "remote". This example was actual used by the authors.
  687.        We could also invision a BBS being run on the "remote" and the
  688.        "server" being used as non-dedicated aux. storage for the BBS.
  689.  
  690.  
  691.                 |
  692.                 | ^
  693.                 | |
  694.                 | --------- to phone line
  695.            +--------+
  696.            |  o o o | <----- external modem
  697.            +--------+
  698.                 |
  699.                 | Com2
  700.                 |
  701.                 |
  702.             'REMOTE'                                         'SERVER'
  703.  
  704.         +---------------+                                +---------------+
  705.         |  +---------+ o|                                |  +---------+ o|
  706.         |  |A:>PC-TAL| o|                                |  | Partners| o|
  707.         |  |         |  |                                |  |   v1.1  |  |
  708.         |  |         |  |                                |  |Copyright|  |
  709.         |  +---------+  |                                |  +---------+  |
  710.         +---------------+                                +---------------+
  711.    +------------------------+          Com1         +------------------------+
  712.    | IBM    o        o      |   Rs232  ----  cable  | IBM    +        o      |
  713.    |  PC    --=--    --=--  | ---------|  |---------|  PC    --=--    --=--  |
  714.    |                        |          ----         |                        |
  715.    +------------------------+                       +------------------------+
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.                                    - 10 -
  737.  
  738.  
  739.  
  740.                              Usage Example NO. 2
  741.  
  742.  
  743.          This simple illustration shows how EQUAL PARTNERS could be used
  744.        to collect data from various other PC's. As an example, lets say
  745.        that you are in the insurance business. Your company has an AT
  746.        in the home office and you have your agents out in the field
  747.        taking orders and collecting premiums. The agents were given
  748.        lap-tops , with 3.5 drives. Now you need to get the information
  749.        stored on the lap-tops to the AT to update the databases.
  750.  
  751.         The PARTNERS half of EQUAL PARTNERS could be activated on the
  752.       AT and as each agent comes in they just "plug" into the RS232
  753.       cable attached to the AT. PARTNERS, on the AT, does not care what
  754.       the other devices are on the end of the RS232 cable at any given
  755.       time. PARTNERS will automatically adjust to the drive character-
  756.       istics of what ever "remote" drive unit it reads. So, you can
  757.       "plug" into the cable attached to the AT, then when through,
  758.       "unplug" and "plug" in another "remote", wheather it be a laptop
  759.       with 3.5 drives, a laptop with an internal harddisk, or PC/XT/AT
  760.       with a DOS formatted disk drive of some type.
  761.  
  762.                                 'SERVER'
  763.                             +---------------+
  764.                             |  +---------+ o|
  765.                             |  | Partners| o|
  766.                             |  |   v1.1  |  |
  767.                             |  |Copyright|  |
  768.                             |  +---------+  |
  769.                             +---------------+
  770.                        +------------------------+
  771.                        | IBM   +----+   --=--   |
  772.                        |  AT   |o   |   --=--   |
  773.                        |       +----+           |
  774.                        +------------------------+
  775.                                      |
  776.                                      |
  777.                                   +-----+
  778.                                   |     | <----- null modem
  779.                                   +-----+
  780.                                      |
  781.                                      |
  782.                                    mmmmm
  783.  
  784.  Agent "A"                                                             Agent "C"
  785.            wwwww                      wwwww                       wwwww
  786.              |                          |                           |
  787.      +-------------+             +-------------+             +-------------+
  788.      | +---------+ |             | +---------+ |             | +---------+ |
  789.      | |A:>COPY  | |             | |A:>COPY  | |             | |A:>COPY  | |
  790.      | |         | |             | |         | |             | |         | |
  791.      | |         | |             | |         | |             | |         | |
  792.      | +---------+ |             | +---------+ |             | +---------+ |
  793.      +-------------+             +-------------+             +-------------+
  794. +-----------------------+  +------------------------+  +-----------------------+
  795. | IBM convertible       |  | Zenith 181             |  | Toshiba 3100 +        |
  796. +-----------------------+  +------------------------+  +-----------------------+
  797.  
  798.                                    - 11 -
  799.  
  800.  
  801.                              Usage Example NO. 3
  802.  
  803.  
  804.          This simple illustration shows how EQUAL PARTNERS could be used
  805.        to share data among various PC's. This example shows a "server"
  806.        attached to a "switch box" by a RS232 cable. A switch box allows the
  807.        manual switching of internal connections between one "common" and
  808.        several other devices attached as "A","B","D" and "E" and such. The
  809.        devices are connected through "C" and what ever setting the physical
  810.        switch is pointing to. This arrangement could allow several PC's to
  811.        be attached to a "server" and data updated on the "server" or the
  812.        "server" used just to store the data prior to "switching" it to
  813.        another PC. The "server' does not have to be dedicated, only activat-
  814.        ed when actual data transfer is needed.
  815.  
  816.                                 'SERVER'
  817.                             +---------------+
  818.                             |  +---------+ o|
  819.                             |  | Partners| o|
  820.                             |  |   v1.1  |  |
  821.                             |  |Copyright|  |
  822.                             |  +---------+  |
  823.                             +---------------+
  824.                        +------------------------+
  825.                        | IBM   +----+   --=--   |
  826.                        |  AT   |o   |   --=--   |
  827.                        |       +----+           |
  828.                        +------------------------+
  829.                                      |
  830.                                      |
  831.                                 +--------+
  832.                                 |        | <----- null modem
  833.                                 +--------+
  834.                                      |
  835.                                      |
  836.                             +----------------+
  837.                             |        C       |
  838.                             |       /        |
  839.                             |      /         | <---------- Switch box
  840.                             |  a  b     d  e |
  841.                             +----------------+
  842.                                ^  ^     ^
  843.                    (a)         |  |     |        (d)
  844.              +------------------  |     ----------------------------+
  845.              |                    |                                 |
  846.              |                     +----+                           |
  847.              |                          | (b)                       |
  848.              |                          |                           |
  849.      +-------------+             +-------------+             +-------------+
  850.      | +---------+ |             | +---------+ |             | +---------+ |
  851.      | |A:>DBASE | |             | |A:>COPY  | |             | |A:>WORD  | |
  852.      | |         | |             | |         | |             | |         | |
  853.      | |         | |             | |         | |             | |         | |
  854.      | +---------+ |             | +---------+ |             | +---------+ |
  855.      +-------------+             +-------------+             +-------------+
  856. +-----------------------+  +------------------------+  +-----------------------+
  857. | IBM AT          --=-- |  | Zenith 181             |  | Toshiba 3100 +        |
  858. +-----------------------+  +------------------------+  +-----------------------+
  859.  
  860.                                    - 12 -
  861.  
  862.  
  863.  
  864.  
  865.                              PROGRAM UPDATE SERVICE
  866.  
  867.  
  868.  
  869.      A license to EP  entitles you to use all future Shareware versions. New
  870.      "restricted usage" versions are generally available through normal
  871.      freeware distribution channels, and we prefer that you obtain them that
  872.      way.
  873.  
  874.      A Program disk containing the latest version is returned on every
  875.      order of $40 or more.  If you wish to purchase a single-user license
  876.      and want an update disk, please enclose a check or money order for $40.
  877.  
  878.      For a fee of $50 per year you can subscribe to our program update
  879.      service.  Subscribers get up to five program updates per year mailed
  880.      to them as new versions come out.  This does not include trivial
  881.      releases.
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                    - 13 -
  922.  
  923.  
  924.  
  925.  
  926.                                  VERSION NUMBERS
  927.  
  928.  
  929.  
  930.      All of our version numbers are given as a number with two decimal
  931.      places.
  932.  
  933.      The units indicate a major revision, such as adding a new feature, maybe
  934.      such as virtual printer support.
  935.  
  936.      The first decimal place (tenths) indicates a minor revision that is
  937.      not essential, but which may be desired.
  938.  
  939.      The second decimal place (hundredths) indicates a trivial revision
  940.      that will probably only be desired by specific individuals or by die-
  941.      hard "latest version" fanatics.
  942.  
  943.  
  944.      To sum up: If the units change, then you should get the newer version
  945.      as soon as you can.  If the tenths change, then you may want to get
  946.      the newer version, but there's no hurry.  If anything else changes,
  947.      then you probably shouldn't bother.
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.                                    - 14 -
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  TECHNICAL REQUIREMENTS AND NOTES
  989.  --------------------------------
  990.  
  991.       Equal Partners uses the RS-232C hardware to interface the PC's and
  992.      provide the 'bridge' to allow the exchange of data.
  993.  
  994.       The hardware consists of the standard 8250 uarts and the DB-25
  995.      or DB-9 connectors and cables. However , only pins 2, 3, and 20,
  996.      are used. Also pins 2 and 3 are required to be crossed-over,
  997.      or you can build or purchase a modem eliminator/null modem.
  998.  
  999.      (See your local electronics parts dealer: such as RADIO SHACK)
  1000.  
  1001.       This is the basic diagram of the CROSS-OVER pin configuration
  1002.  
  1003.  
  1004.                   'SERVER'               'REMOTE'
  1005.  
  1006.                    ------                 ------
  1007.                    |    |                 |    |
  1008.                    |  2 |--------------\ /|2   |  Pins
  1009.                    |    |               / |    |
  1010.                    |  3 |--------------/ \|3   |
  1011.                    |    |                 |    |
  1012.                    | 20 | ----------------|20  |
  1013.                    ------                 ------
  1014.                     DB-25                 DB-25
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.                                    - 15 -
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.      The following are notes and considerations both technical
  1051.     and otherwise, these must be noted and HEEDED:
  1052.  
  1053.          1). Both EQUAL.COM and PARTNERS.COM use COM1 or
  1054.              COM2 as the 'bridge'. The port addresses are
  1055.              disabled so that Basic will not interfere, as
  1056.              Basic tries to take over the com ports when
  1057.              loaded, even if does not need them. Com1 is
  1058.              only available for the shareware version.
  1059.  
  1060.               The program , 'PARTNERS.COM' will revector
  1061.              and restore the com ports addresses when it
  1062.              is de-actived however.
  1063.  
  1064.          2). The program ,'EQUAL.COM', installs resident and
  1065.            attaches itself to DOS, so that once installed its
  1066.            there to stay.
  1067.  
  1068.          3). The data transfer rate is 9,600 baud for the shareware
  1069.             version. Registered users may select rates up to 110,000
  1070.             baud.
  1071.  
  1072.          4). Error checking is performed on each block of
  1073.             data. Crc-16 is used to insure the integrity of
  1074.             your financial data and programs.
  1075.  
  1076.          5).  Ramdisks with sector sizes between 128 and 512
  1077.              bytes are supported. This applies to other disk
  1078.              media as well. The sector sizes must be a power
  1079.              of 2.
  1080.  
  1081.          6). The operating systems on ALL remote(s) and the server
  1082.             SHOULD/MUST be identical. Mixing DOS versions accessing
  1083.             the same data and media MAY/WILL cause problems. Some
  1084.             versions of DOS do not support media types made available
  1085.             in later versions of DOS, so some DOS utilities may not
  1086.             function correclty when accessing disk media or using
  1087.             function calls that were added/modified in later releases
  1088.             of DOS (ex: CHKDSK).
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.                                    - 16 -
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  Appendix A - Program Messages.
  1112.  
  1113.  
  1114.  
  1115.       All message text is preceeded by a formatted message code.
  1116.  
  1117.     The format of the message code is:
  1118.  
  1119.                   EPxNNNy
  1120.  
  1121.      where :
  1122.  
  1123.           x= 'D' - for 50-50.SYS  program output messages
  1124.  
  1125.              'E' - for EQUALS.COM program output messages
  1126.  
  1127.              'P' - for PARTNERS.COM program output messages
  1128.  
  1129.         and
  1130.  
  1131.  
  1132.           NNN= 000 thru 999, which is the message number for this
  1133.                             message type.
  1134.  
  1135.         and
  1136.  
  1137.           y= 'D' - for Dignostic type messages. These messages are
  1138.                   normally printed only if a critical error occurs
  1139.                   or the program is in a 'test' or debugging mode.
  1140.  
  1141.              'E' - for Error messages. These type messages indicate
  1142.                    that an unrecoverable error occured and the program
  1143.                    could not take any corrective action, except to
  1144.                    attempt to return to the DOS prompt.
  1145.  
  1146.              'I' - for Informative messages. These messages are just
  1147.                    to inform you  as to the processing state of the
  1148.                    program at any given time.
  1149.  
  1150.              'W' - for Warning messages. These messages indicate
  1151.                    that an error occured, but that the program
  1152.                    was able to take corrective action and continue
  1153.                    processing. However, the function the program was
  1154.                    attempting may or may not have been successfully
  1155.                    completed.
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.                                    - A1 -
  1169.  
  1170.  
  1171.  
  1172.       Message Code         Message text and its explanation
  1173.       ------------    ----------------------------------------------------
  1174.  
  1175.         EPD001I - EQUAL PARTNERS Virtual disk driver V1.10
  1176.                   (C)Copyright DOWNLINK SYS. INC. 1986
  1177.  
  1178.                   This is the copyright message displayed from the
  1179.                   virtual disk device driver during PC power-up.
  1180.  
  1181.         EPD002I - 1 virtual disk drive(s) available to DOS
  1182.  
  1183.                   This message indicates the number of additional
  1184.                   disk drives ('virtual') that DOS can access. These
  1185.                   drives may be accessed by the  DOS commands or any
  1186.                   program by using the drive letters assigned, by DOS,
  1187.                   to the virtual disks. Registered users may access up
  1188.                   to 8 virtual disks, the shareware version allows
  1189.                   access to only 1 virtual disk.
  1190.  
  1191.         EPE001E - installation cancelled - COM channel undefined
  1192.  
  1193.                   The program was trying to install, but was unable
  1194.                   to find a communications port address at the desired
  1195.                   memory location. The only recourse is to return to
  1196.                   DOS.
  1197.  
  1198.         EPE002E - installation cancelled - 50-50 driver not installed
  1199.  
  1200.                   The device driver, 50-50.sys, was not included in the
  1201.                   DOS file 'config.sys'. If your intent is to run this
  1202.                   PC as a 'remote', then see the INSTALLATION section
  1203.                   for the correct program configurations.
  1204.  
  1205.         EPE003E - installation cancelled - ALREADY installed
  1206.  
  1207.                   The program EQUAL.COM has already been installed once.
  1208.                   Multiple installations are not allowed.
  1209.  
  1210.         EPE000I - EQUAL activated - Communications link is COMx
  1211.  
  1212.                   This message relects that the installation of EQUAL is
  1213.                   in progess and that the Communications port, COMx, was
  1214.                   the port selected to link the "remote" to the "server"
  1215.  
  1216.         EPE001I - EQUAL installed - Virtual drives C: thru C: available for use
  1217.  
  1218.                   This is the most important type 'I' message that is
  1219.                   displayed.  This message reflects the  additional 'drive'
  1220.                   letters you use on all DOS commands and in programs, to
  1221.                   access data on the 'server' PC.
  1222.                      The drive letters displayed depends on the number of
  1223.                   virtual drives requested (up to 8 allowed) on the
  1224.                   'device=50-50.sys' statement in the DOS 'config.sys' file.
  1225.  
  1226.         EPE999I - EQUAL shutdown - returning to DOS
  1227.  
  1228.                   This message indicates that EQUAL.COM is returning to
  1229.                   DOS. See any additional messages for the exact reason.
  1230.  
  1231.                                    - A2 -
  1232.  
  1233.  
  1234.  
  1235.  
  1236.       Message Code         Message text and its explanation
  1237.       ------------    ----------------------------------------------------
  1238.  
  1239.  
  1240.         EPP001E - installation cancelled - COM channel undefined
  1241.  
  1242.                   The program was trying to install, but was unable
  1243.                   to find a communications port address at the desired
  1244.                   memory location. The only recourse is to return to
  1245.                   DOS.
  1246.  
  1247.         EPP002E - installation cancelled - EQUAL is already installed
  1248.  
  1249.                   The program is trying to be installed on a machine
  1250.                   that already has the EQUAL.COM program installed.
  1251.                   You can't make one machine both a 'remote' and a
  1252.                   'server'.
  1253.  
  1254.         EPP000I - PARTNERS activated - Communications link is COMx
  1255.  
  1256.                   This message relects that the installation of PARTNERS
  1257.                   is in progess and that the Communications port, COMx,
  1258.                   was the port selected to link the "server" to the "remote".
  1259.  
  1260.         EPP001I - PARTNERS installed -waiting for remote responce
  1261.  
  1262.                   You have entered PARTNERS from the Dos prompt or in
  1263.                   a batch file. PARTNERS is now installed (not resident)
  1264.                   and is waiting for RS-232 input on the communications port.
  1265.                   The programs EQUAL.COM and 50-50.SYS have to be installed
  1266.                   on the "remote" computer to complete the "bridge",so
  1267.                   that data may be freely transfered between computers.
  1268.  
  1269.         EPP999I - PARTNERS shutdown - returning to DOS
  1270.  
  1271.                   You have either pressed the 'ESC' key or installation
  1272.                   failed.
  1273.  
  1274.         EPP001W - Invalid I/O request - flushing input buffer
  1275.  
  1276.                   Extraneous or corrupted information was received. The
  1277.                   programs only recourse is to ignore the data, flush
  1278.                   all buffers and try to get in sync with the other PC.
  1279.  
  1280.         EPP001D - AX=      BX=     CX=    DX=
  1281.  
  1282.                   This message displays the internal register states.
  1283.                   The message is normally display only when a critical
  1284.                   error occurs or the programs debugging mode is active.
  1285.  
  1286.         EPP002D -     -
  1287.  
  1288.                   This message is preceeded by message code EPP001D.
  1289.                   Several additional message lines will be displayed
  1290.                   indicating the reason for this diagnostic message.
  1291.  
  1292.  
  1293.                                    - A3 -
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  Appendix B - Site License
  1299.  
  1300.  
  1301.  
  1302.                                   SITE LICENSE
  1303.  
  1304.  
  1305.  
  1306.      Corporate users may wish to obtain a site license for the use of EP.
  1307.      The site license applies only to one geographical area, not to exceed
  1308.      a 50 mile radius. Additional site licenses are required for each
  1309.      unique geographical location.
  1310.  
  1311.       Please use the order form in this manual to order a site license.
  1312.      Site licenses are granted when we receive your payment. License fees
  1313.      vary depending on the number of computers on which EP  will be used,
  1314.      as follows:
  1315.  
  1316.           1 to  9 copies  $40 each
  1317.          10 to 24 copies  $35 each
  1318.          25 to 49 copies  $30 each
  1319.          50 to 99 copies  $25 each
  1320.          over  99 copies  $3000 one time fee
  1321.  
  1322.  
  1323.  
  1324.      The following page is a site license agreement, which should be signed
  1325.      and sent with your payment when ordering a commercial site license.
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.                                    - B1 -
  1356.  
  1357.  
  1358.      The use of EP  in a commercial environment or government organization
  1359.      is granted under the following terms:
  1360.  
  1361.      1.  Payment of the license fee must be made payable to Downlink
  1362.         representative
  1363.  
  1364.  
  1365.          D. Conner
  1366.  
  1367.          The fee is based on the number of computers which will be used
  1368.          to run EP , as follows:
  1369.  
  1370.                1 to  9 copies  $40 each
  1371.               10 to 24 copies  $35 each
  1372.               25 to 49 copies  $30 each
  1373.               50 to 99 copies  $25 each
  1374.               over  99 copies  $3000 one time fee
  1375.  
  1376.      2.  You may use EP  on the number of computers included in the license
  1377.          fee.  If you have paid the fee for over 99 copies, then you may
  1378.          use EP  on any number of computers within your organization, within
  1379.          a given geographical area.
  1380.  
  1381.      3.  You may make copies of the program and documentation, in their
  1382.          original,  unmodified form. You may distribute these copies, within
  1383.          the limits of the number of copies licensed.
  1384.  
  1385.      4.  You may make copies of the program documentation, in both its
  1386.          printed form and machine readable form, without restriction.
  1387.  
  1388.      5.  You may use all future "restricted-usage" Shareware versions of EP
  1389.          under this license.
  1390.  
  1391.          The latest version is available from Downlink  for a small service
  1392.          charge.
  1393.  
  1394.      6.  You may NOT modify the program or charge a fee for copying or
  1395.          distributing the program or its documentation.
  1396.  
  1397.      7.  It is your responsibility to make the necessary copies and to
  1398.          deliver them to the computers which they will be used on.
  1399.  
  1400.      8.  We are not responsible for anything that may happen or not happen
  1401.          if you use EP.  You're on your own.
  1402.  
  1403.  
  1404.          I agree to abide by the terms and conditions of this license.
  1405.  
  1406.          _____________________________         __________________________
  1407.          Signature                             Date
  1408.  
  1409.          _____________________________
  1410.          Name (please print or type)
  1411.  
  1412.          _____________________________
  1413.          Title
  1414.  
  1415.          _____________________________
  1416.          Company
  1417.  
  1418.                                    - B2 -
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  Appendix D - Ordering
  1424.  
  1425.  
  1426.  
  1427.  
  1428.                                    ORDER FORM
  1429.  
  1430.  
  1431.  
  1432.      Check which items you wish to purchase:
  1433.  
  1434.          (_) Noncommercial license for the use of EP.
  1435.  
  1436.          (_) Commercial license for the use of EP on ___ computers (see
  1437.              price schedule and terms on preceding page).
  1438.  
  1439.          (_) Program update subscription service (not more than five
  1440.              updates, does not include trivial changes), $50/year.
  1441.  
  1442.          (_) Payment of $_____ is enclosed (check or money order).
  1443.  
  1444.  
  1445.              Signature: ________________________________
  1446.  
  1447.          _______________________________________________
  1448.          Name
  1449.  
  1450.          _______________________________________________
  1451.  
  1452.  
  1453.          _______________________________________________
  1454.          Address
  1455.  
  1456.          ______________________   ________  ____________
  1457.          City                     State     Zip
  1458.  
  1459.  
  1460.      Send this completed form to:
  1461.  
  1462.                                  Downlink Systems Inc.
  1463.                                  c/o D. Conner
  1464.                                  1377 K STREET N.W.
  1465.                                  SUITE 189
  1466.                                  WASHINGTON D.C. 20005
  1467.  
  1468.  
  1469.      For program disk orders outside the U.S., please add an additional $5,
  1470.      and enclose an international money order payable in U.S. currency.
  1471.  
  1472.      For commercial site license orders, please enclose a signed copy of
  1473.      the site license agreement.
  1474.  
  1475.      Inquires for Corporate wide unlimited usage licenses are welcome.
  1476.  
  1477.  
  1478.  
  1479.                                    - D1 -
  1480.  
  1481.